はじめにMac OS X では、警告音とサウンドエフェクト用に優先的に使用するオーディオデバイス（Default System Output Device）と、システムによって生成されるその他のオーディオ用のサウンド出力デバイス（Default Output Device）をユーザが各自で選択できます。同じデバイス（内蔵スピーカーなど）を設定することも、まったく異なる 2 つのデバイスを設定することもできます。 System Sound API を使って、デベロッパは、警告音に関するすべてのシステム設定に従いながら、すべての属性を使って警告音を正しく再生することができます。たとえば、オーディオ出力を利用できない場合や、「消音」または「ユニバーサルアクセス」システム環境設定の「音声」の「警告音が鳴るときに画面を点滅させる」など、ユーザ指定の環境設定がなされているときに画面を点滅させる機能があります。 また、「サウンド」システム環境設定を使って、「ユーザインタフェースのサウンドエフェクトを再生する」チェックボックスをチェックすると、「ユーザインタフェースのサウンドエフェクト」を正しく再生することができます（図 1 を参照）。 どちらの場合も、オーディオの出力先は、警告とサウンドエフェクト用に選択した Default System Output Device になります。 図 1 では警告音とサウンドエフェクト用の Default System Output デバイス（「警告とサウンドエフェクトの再生装置」ポップアップメニューから選択）が「内蔵スピーカー」に設定され、図 2 では Default Output Device は「EDIROL UA-3D USB」デバイスに設定されています。 一般的なユーザ設定では、iTunes で購入したミュージックは USB スピーカー（Default Output Device）で再生し、警告とサウンドエフェクトは内蔵スピーカー（Default System Output Device）で再生します。System Sound API を使用すると、アプリケーションが警告とサウンドエフェクトを間違ったデバイス（たとえば、SpinalTap のグレイティストヒットを大音量で演奏するようにボリュームを上げたスピーカー）で再生しないように保証されます。 注意： 警告音を使用するアプリケーションであれば、NSSound や QuickTime などの大掛かりな方法ではなく、System Sound API を使うのが適したアプローチです。  図 1. 警告とサウンドエフェクト  図 2. サウンド出力 System Sound API以下の API は、"SystemSound.h" に定義されています。"SystemSound.h" は、CoreServices 包括フレームワークに属する OSServices フレームワークの一部です。 警告音（Mac OS X 10.2 以降で利用可能） 警告音を再生するには 2 つの API があります。
void AlertSoundPlay(void);
void AlertSoundPlayCustomSound(SystemSoundActionID inAction) inAction: AlertSound の動作で再生するサウンドを示す SystemSoundActionID。 ユーザインタフェースのサウンドエフェクト（Mac OS X 10.3 以降で利用可能） ユーザインタフェースのサウンドエフェクトを再生する API は 1 つです。
警告： 技術的に正しいですが、 void SystemSoundPlay(SystemSoundActionID inAction) inAction: 再生するシステムサウンドを示す SystemSoundActionID。 SystemSoundActionID の作成（Mac OS X 10.2 以降で利用可能）
OSStatus SystemSoundGetActionID(
const FSRef * userFile,
SystemSoundActionID * outAction)
userFile: システムサウンドとして使用するオーディオファイルに対応する const FSRef * 。
AudioToolbox フレームワークの AudioFile API でサポートされている
任意のオーディオファイル。
outAction: 成功すると、SystemSoundActionID が返される。
これを SystemSoundPlay() または AlertSoundPlayCustomSound() に渡す。
OSStatus SystemSoundRemoveActionID(SystemSoundActionID inAction) inAction: 削除するシステムサウンドを示す SystemSoundActionID。 完了ルーチン（Mac OS X 10.3 以降で利用可能） 完了ルーチンを扱う API は 2 つあります。
OSStatus SystemSoundSetCompletionRoutine(
SystemSoundActionID inAction,
CFRunLoopRef inRunLoop,
CFStringRef inRunLoopMode,
SystemSoundCompletionUPP inCompletionRoutine,
void * inUserData
inAction: 完了ルーチンが関連付けられる SystemSoundActionID。
inRunLoop: 完了ルーチンの対象となる実行ループを示す CFRunLoopRef indicating。
メインループの場合は NULL を渡す。
inRunLoopMode: 完了ルーチンが実行される、実行ループの実行ループモードを
示す CFStringRef。
kCFRunLoopDefaultMode を使用するには NULL を渡す。
inCompletionRoutine: 指定された SystemSoundActionID がサーバでの再生を完了したときに
呼び出される完了ルーチンを示す SystemSoundCompletionProc。
inUserData: ユーザデータを完了ルーチンに渡すための void * 。
void SystemSoundRemoveCompletionRoutine(SystemSoundActionID inAction) inAction: 完了ルーチンが現在関連付けられている SystemSoundActionID。 使用例リスト 1. カスタム警告音の再生 SystemSoundActionID gFunkSoundID = 0;
OSStatus CreateFunkActionID(void)
{
const char *soundFilePath = "/System/Library/Sounds/Funk.aiff";
FSRef soundFileRef;
OSStatus err;
err = FSPathMakeRef(soundFilePath, &soundFileRef, NULL);
if (noErr == err) {
err = SystemSoundGetActionID(&soundFileRef, &gFunkSoundID);
}
return err;
}
void MyDoSomethingFunction(void)
{
.
.
.
if (badBadThing)
AlertSoundPlayCustomSound(gFunkSoundID);
// 注記：この呼び出しの直後に Action ID を削除しないように
// 注意すること。システムに対して、実際にサウンドを再生する機会を
// 与える必要がある。
.
.
.
}
void MyCleanUpActionID(void)
{
// 処理を完了したら
// ActionID の SystemSoundRemoveActionID を呼び出す。
// 注記：上の注記でも示したように、システムにサウンドを再生する機会を与える前に
// Action ID を削除してしまわないようにする。
SystemSoundRemoveActionID(gFunkSoundID);
}
ドキュメントの改訂履歴
掲載日： 2004-07-13 | ||||||||||||
